home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / lisp / clisp-li.000 / clisp-li / clisp-1996-07-22 / README < prev    next >
Encoding:
Text File  |  1996-07-22  |  5.4 KB  |  205 lines
  1. This is CLISP, a Common Lisp implementation.
  2.  
  3.  
  4. What is LISP?
  5. -------------
  6.  
  7. LISP is a programming language. It was invented by J. McCarthy in 1959.
  8. There have been many dialects of it, but nowadays LISP has been standardized
  9. and wide-spread due to the industrial standard COMMON LISP. There are
  10. applications in the domains of symbolic knowledge processing (AI), numerical
  11. mathematics (MACLISP yielded numerical code as good as FORTRAN), and
  12. widely used programs like editors (EMACS) and CAD (AUTOCAD).
  13. There is an introduction to the language:
  14.  
  15.   Sheila Hughes: Lisp. Pitman Publishing Limited, London 1986.
  16.   107 pages.
  17.  
  18. After a while wou will need the standard text containing the language
  19. definition:
  20.  
  21.   Guy L. Steele Jr.: Common Lisp - The Language. Digital Press.
  22.   1. edition 1984, 465 pages.
  23.   2. edition 1990, 1032 pages.
  24.  
  25. This book is available in HTML form via FTP from
  26.   ftp.cs.cmu.edu:/user/ai/lang/lisp/doc/cltl/cltl_ht.tgz  and
  27.   ma2s2.mathematik.uni-karlsruhe.de:/pub/lisp/CLtL2/cltl_ht.tgz
  28. and can be viewed through WWW under
  29.   http://www.cs.cmu.edu:8001/Web/Groups/AI/html/cltl/cltl2.html or
  30.   http://www.cs.cmu.edu:8001/afs/cs/project/ai-repository/ai/html/cltl/cltl2.html .
  31.  
  32. LISP is run in an interactive environment. You input forms, and they will be
  33. evaluated at once. Thus you can inspect variables, call functions with given
  34. arguments or define your own functions.
  35.  
  36.  
  37. Contents:
  38. ---------
  39.  
  40. It consists of the following files:
  41.  
  42.    base/lisp.a            main program, to be linked
  43.    base/lispinit.mem      memory image needed for startup
  44.    doc/clisp.1            manual page in Unix man format
  45.    doc/clisp.man          manual page
  46.    doc/clisp.html         manual page in HTML format
  47.    doc/impnotes.txt       implementation notes
  48.    doc/cltl2.txt          notes about the relation of CLISP to CLtL2
  49.    doc/clreadline.3       line editing manual page in Unix man format
  50.    doc/clreadline.man     line editing manual page
  51.    doc/LISP-tutorial.txt  LISP tutorial for beginners
  52.    doc/CLOS-guide.txt     brief guide to CLOS
  53.    README                 this text
  54.    SUMMARY                short description of CLISP
  55.    ANNOUNCE               announcement
  56.    NEWS                   list of modifications since the last version
  57.    COPYRIGHT              copyright notice
  58.    GNU-GPL                free software license
  59.    doc/readline.dvi       GNU readline library documentation
  60.    src/config.lsp         site-dependent configuration
  61.  
  62. and - to your convenience, if you like reading source -
  63.  
  64.    src/*.lsp              the source of lispinit.mem
  65.    src/*.fas              the same files, already compiled
  66.  
  67. For building the executable, you also need:
  68.  
  69.    base/libreadline.a     GNU readline library
  70.  
  71. or
  72.  
  73.    base/libnoreadline.a   dummy replacement for the GNU readline library
  74.  
  75.  
  76. Software requirements:
  77. ----------------------
  78.  
  79. This version of CLISP requires Linux 1.1.52 or newer.
  80.  
  81.  
  82. Installation:
  83. -------------
  84.  
  85. Type
  86.  
  87.          make
  88.  
  89. Change the strings in src/config.lsp, using a text editor.
  90. Then start
  91.  
  92.          base/lisp.run -M base/lispinit.mem
  93.  
  94. When the LISP prompt
  95.  
  96.       > _
  97.  
  98. appears, type
  99.  
  100.         (compile-file "src/config")
  101.         (load "src/config")
  102.  
  103. and then
  104.  
  105.         (cd "base/")
  106.         (saveinitmem)
  107.  
  108. to overwrite the file lispinit.mem with your configuration. Then
  109.  
  110.         (exit)
  111.  
  112. The rest is done by a simple
  113.  
  114.         make install
  115.  
  116. Instead, you may do this yourself, step by step:
  117.  
  118. Then create a directory, and put the executable and the memory image there.
  119. I would suggest /usr/local/lib/lisp :
  120.  
  121.    mkdir /usr/local/lib/lisp
  122.    mv base/lisp.run /usr/local/lib/lisp
  123.    mv base/lispinit.mem /usr/local/lib/lisp
  124.  
  125. And create a shell script that starts lisp:
  126.  
  127.    cat > /usr/local/bin/clisp
  128.    #!/bin/sh
  129.    exec /usr/local/lib/lisp/lisp.run -M /usr/local/lib/lisp/lispinit.mem "$@"
  130.    [Ctrl-D]EOF
  131.    chmod a+x /usr/local/bin/clisp
  132.  
  133. Now install the man pages
  134.  
  135.    mv doc/clisp.1 /usr/local/man/man1/clisp.1
  136.    mv doc/clreadline.3 /usr/local/man/man3/clreadline.3
  137.  
  138. and try
  139.  
  140.    man clisp
  141.  
  142.  
  143. When you encounter problems:
  144. ----------------------------
  145.  
  146. After errors, you are in the debugger:
  147.  
  148.      1. Break> _
  149.  
  150. You can evaluate forms, as usual. Furthermore:
  151.  
  152.      Help
  153.                calles help
  154.      Abort     or
  155.      Unwind
  156.                climbs up to next higher input loop
  157.      Backtrace
  158.                shows the contents of the stack, helpful for debugging
  159.  
  160. And you can look at the values of the variables of the functions where the
  161. error occurred.
  162.  
  163. On bigger problems, e.g. core dumps, please send a description of the error
  164. and how to produce it reliably to the authors or the maintainer. Please
  165. accompany it with the CLISP version, which you get by calling
  166. (lisp-implementation-version).
  167.  
  168.  
  169. Mailing List:
  170. -------------
  171.  
  172. There is a mailing list for users of CLISP. It is the proper forum for
  173. questions about CLISP, installation problems, bug reports, application
  174. packages etc.
  175.  
  176. For information about the list and how to subscribe it, send mail to
  177. listserv@ma2s2.mathematik.uni-karlsruhe.de, with the two lines
  178.           help
  179.           information clisp-list
  180. in the message body.
  181.  
  182.  
  183. Acknowledgement:
  184. ----------------
  185.  
  186. We are indebted to
  187.   * Guy L. Steele and many others for the Common Lisp specification.
  188.   * Richard Stallman's GNU project for GCC, Autoconf and the readline library.
  189.  
  190.  
  191. Authors:
  192. --------
  193.  
  194.         Bruno Haible
  195.         Michael Stoll
  196.  
  197. Email: haible@ma2s2.mathematik.uni-karlsruhe.de
  198.  
  199. Maintainer:
  200. -----------
  201.  
  202.         Marcus Daniels
  203.  
  204. Email: marcus@sysc.pdx.edu
  205.